home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Den Norske Hjemmedataklubben / Agaton 92-4 (1992)(Data-Tronic AS)(NO)(Disk 1 of 2).zip / Agaton 92-4 (1992)(Data-Tronic AS)(NO)(Disk 1 of 2).adf / s / Space.HELP next >
Text File  |  1992-02-06  |  18KB  |  573 lines
  1.   **************************************************************************
  2.                                S P A C E   I I
  3.                        Copyright (C)1991  Edgar M. Vigdal
  4.   **************************************************************************
  5.   This program is a sharware program, so if you use this program, or have it 
  6.   in your collection of public-domain, you MUST send $20 to :   
  7.  
  8.         EDGAR M. VIGDAL,
  9.         Skipsbygger Hærems vei 5,
  10.         4085 HUNDVÅG,
  11.         NORWAY
  12.  
  13.   You will then become a registered user and receive new versions and other
  14.   utilities that I have made.
  15.   **************************************************************************
  16.  
  17.  
  18.  
  19.  
  20.   ==========================================================================
  21.   --------------------------------------------------------------------------
  22.                                   SPACE II
  23.   --------------------------------------------------------------------------
  24.   ==========================================================================
  25.  
  26.  
  27.  
  28.  
  29.                      The Space Screen Blanking Utility.
  30.  
  31.   This program started out as a simple screen blanking program, but now
  32.   in it's latest version (v2.0) it has over 30 utilities built in to
  33.   only 43 Kbytes of pure assembler code.
  34.   The program is a resident utilitiy that will be placed in the background,
  35.   and will be activated with keypresses. It has been tryed to be keept as
  36.   small as possibel, so that the small memory it occupies can be justified
  37.   by the usefullness of the many utilities it provides.
  38.   The program uses a inputhandler for linking into the stream of input events,
  39.   and is almost invisible for other programs. The time I have used it, no 
  40.   interference with other program has occured, but if you discover some bugs
  41.   than please let me know !!!. If you have ideas for more short utilities that
  42.   you would have liked to see inside it, then send me a description of the
  43.   utility and I will try to work it out.
  44.  
  45.  
  46.   List of current utilities: (No spesific order)
  47.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  48.   1.  Screen blanker.                    
  49.   2.  Mouse blanker.
  50.   3.  Text viewer.                ALT/SHIFT/CTRL  READ
  51.   4.  Hex dump of files.            ALT/SHIFT/CTRL  READ
  52.   5.  IFF-picture viewer.            ALT/SHIFT/CTRL  VIEW IFF
  53.   6.  Sound player.                ALT/SHIFT/CTRL  SOUND
  54.   7.  Make new directory.            ALT/SHIFT/CTRL  MAKEDIR
  55.   8.  Rename files.                ALT/SHIFT/CTRL  RENAME
  56.   9.  Move files.                ALT/SHIFT/CTRL  MOVE
  57.   10. Copy files.                ALT/SHIFT/CTRL  COPY
  58.   11. Delete files.                ALT/SHIFT/CTRL  DELETE
  59.   12. Set protection flags.            ALT/SHIFT/CTRL  <HSPARWED>
  60.   13. Directory to printer.            ALT/SHIFT/CTRL  DIR > PRT
  61.   14. Program runner.                ALT/SHIFT/CTRL  RUN
  62.   15. Text printer.                ALT/SHIFT/CTRL  READ Shift P
  63.   16. Directory lister.                ALT/SHIFT/CTRL
  64.   17. Device info.                ALT/CTRL      F1
  65.   18. Memory info.                ALT/CTRL      F2
  66.   19. Palette.                    ALT/CTRL      F3
  67.   20. Calculator.                ALT/CTRL      F5
  68.   21. Mouse Blanker OFF.            ALT/CTRL      F6
  69.   22. Mouse Blanker ON.                ALT/CTRL      F7
  70.   23. Screen dumper.                ALT/CTRL      F8
  71.   24. Alarm.                    ALT/CTRL      F9
  72.   25. Save screens as IFF-pictures.        ALT/CTRL      F10
  73.   26. Audio filter On/Off.            ALT/CTRL      *     (Keypad)
  74.   27. 50/60Hz Switch.                ALT/CTRL      /     (Keypad)
  75.   28. Text rescue.                ALT/CTRL      ENTER (Keypad)
  76.   29. Display boot-block on disks in DF0:.    ALT/CTRL      4     (Keypad)
  77.   30. Install disk in DF0.            ALT/CTRL      5     (Keypad)
  78.   31. UnInstall disks in DF0:.            ALT/CTRL      6     (Keypad)
  79.   32. Two blanking mode. Spacetrip and Dimmer.    ALT/CTRL     .     (Keypad)
  80.   33. Disable/Enable virus checker        ALT/CTRL     9     (Keypad)
  81.   34. Virus checker.
  82.   35. Screen shuffler with activate.        ALT/CTRL      CRSR UP
  83.   36. Screen shuffler without activate.        ALT/CTRL      CRSR DOWN
  84.   37. Window shuffler, Front to back.        ALT/CTRL      CRSR LEFT
  85.   38. Window shuffler, Back to Front.        ALT/CTRL      CRSR RIGHT
  86.   39. Exec Vectors display.            ALT/CTRL      BACKSPACE
  87.  
  88.   in 40764 bytes.
  89.  
  90.  
  91.  
  92.  
  93.   ...........................................................................
  94.   This document will surely look like shit to a person with good knowledge to
  95.  
  96.   the right syntax of the english language, but please have mercy with a
  97.  
  98.   norwegian the do not care about the syntax as long as the deep meaning of
  99.  
  100.   the text can be understood. If somebody feel the need to fix some            
  101.  
  102.   misspelling, then for heavens sake do it, BUT leave my address intact
  103.  
  104.   in the document or else I will add it for you!!!!
  105.   ...........................................................................
  106.  
  107.  
  108.  
  109.  
  110.  
  111. FILE REQUESTER            ALT/SHIFT/CTRL
  112. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
  113.   With this very good file requester you could do a list of a directory 
  114.   by pressing 3 keys and than use the mouse and click around in a 
  115.   disk directory.
  116.  
  117.   By selecting a file a new window will open and many new options will
  118.   be displayed. The gadgets provides the following:
  119.  
  120.     RUN        This will try to start up a selected program
  121.             and run it as a new task.
  122.  
  123.     MAKEDIR        This will prompt for a name of the new directory
  124.             and create the directory.
  125.  
  126.     DELETE        This will delete the selected file. (Be carefull!)
  127.  
  128.     RENAME        This will prompt for a new name and than rename
  129.             the selected file.
  130.  
  131.     DIR        This will bring up the filerequester and a new
  132.             file can be selected.
  133.  
  134.     DIR > PRT    This will send a selected directory to the printer,
  135.             or a file that you choose.
  136.  
  137.     COPY        This will prompt you for a new filename and than
  138.             make a copy of the old file.
  139.  
  140.     MOVE        This will prompt for a name and than move the file.
  141.  
  142.     READ        This will read a ascii text or a PowerPacked
  143.             document and display it.
  144.             You can also use it to read programs, text or any
  145.             files in hex dump. Press <H> to enter hex mode.
  146.             (Press HELP for instructions on the text-viewer.)
  147.  
  148.     VIEW IFF    This will load and display a IFF-picture.
  149.  
  150.  
  151.     SOUND        This will load and play IFF/RAW samples.
  152.  
  153.     HELP        This will load the help text (This text.)
  154.  
  155.  
  156.   There are some hidden gadgets under the letters that shows the
  157.   protection bits <HSPARWED>. By clicking on the letters you can set
  158.   the protection for the selected file.
  159.  
  160.     H       Hidden
  161.     S    Script
  162.     P    Pure
  163.     A    Archived
  164.     R    Read
  165.     W    Write
  166.     E    Edit
  167.     D    Delete
  168.  
  169.   When the requester is open you can close it by selecting 'Forget it'
  170.   or the close gadget in the left upper corner.
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177. IFF VIEWER        ALT/CTRL F1   VIEW IFF
  178. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  179.   When you are viewing a picture, you adjust the palette for the picture by
  180.   pressing F3 or you can dump the picture to the printer. You must of course
  181.   have a printer connected and a printer driver selected.
  182.  
  183.   The screendump is achieved by pressing F8 and then clicking the OK gadget.
  184.  
  185.  
  186.  
  187.  
  188.  
  189. FILE RUNNER            ALT/CTRL F1   RUN
  190. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  191.   After you have double clicked or selected a filename and than select
  192.   the run gadget, a new task will be created and the selected program will
  193.   start running.
  194.  
  195.   This may not work with every program.
  196.  
  197.   *
  198.   * If anybody have a source that shows how you can run a program in a
  199.   * good way, I would really want to see it.
  200.   *
  201.   *    It must be something like this:
  202.   *
  203.   *    o   LoadSegment.
  204.   *    o   CreateProcess.
  205.   *    o   kickStart the new task(process). Make it actually run.
  206.   *         This is the tricky bit.
  207.   *
  208.   * The problem is that if you use the execute command in dos.library to
  209.   * run a program, and than closes the CLI, from where you started Space II,
  210.   * the program runned will not know where to send it's output. 
  211.   * If you see what I meen. ?
  212.   *
  213.  
  214.  
  215.  
  216.  
  217.  
  218. TEXT VIEWER        ALT/SHIFT/CTRL   READ
  219. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
  220.   This will load a text and display it in a window. The text viewer has
  221.   some advanced options. It has very fast text scrolling and very fast
  222.   searching after text in the document. (It scans thru ca. 120000 chars
  223.   pr. second). It can also load PowerPacked docs. The text viewer can
  224.   also be used as a hex dump viewer, any files can be loaded and viewed.
  225.   More help on the TextViewer will be displayed when you press HELP
  226.   when you are viewing a document. (Try it now !)
  227.  
  228.   You can also open a new file by pressing ALT/SHIFT/CTRL. If you have
  229.   allready opened a text, the Text Viewer window will be closed and the
  230.   file requester will be displayed.
  231.  
  232.   If the Text Viewer window is covered by other windows and you click in
  233.   the Text Viewer window, it will be brought to the front and activated.
  234.  
  235.   NB **
  236.   You must have the 'powerpacker.library' in the Libs: directory for
  237.   loading power packed docs/texts/files.
  238.  
  239.  
  240.  
  241.  
  242.  
  243. DEVICE INFO                  ALT/CTRL F1
  244. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  245.   This will show what devices(disks,harddisks,ramdisks) that are in the
  246.   system. The disks total size, how much has been used of it and how
  247.   much is free on it will be displayed. 
  248.  
  249.  
  250.  
  251.  
  252.  
  253. MEMORY INFO                  ALT/CTRL F2
  254. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  255.   This will display the amount of random access memory (RAM) in you system. 
  256.   It will show both Chip-RAM and Fast-RAM, and the locations for both. The 
  257.   greatest blocks of free continues memory is also displayed.
  258.  
  259.  
  260.  
  261.  
  262.  
  263. PALETTE                      ALT/CTRL F3
  264. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  265.   This will bring up a palette, so you may adjust the colours on the
  266.   current screen.
  267.  
  268.  
  269.  
  270.  
  271.  
  272. FILE COPY                    ALT/CTRL F4
  273. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  274.   This is a simple file copying utility. You use the filerequester to choose 
  275.   the file to copy and click on the 'OK' gadget and then select/write the
  276.   name of the new file and confirm the copy.
  277.  
  278.  
  279.  
  280.  
  281.  
  282. CALCULATOR                   ALT/CTRL F5
  283. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  284.   How many times have you needed a calculator and looked all over for it. 
  285.   Well now it's just a keypress away. 
  286.  
  287.   It is a bit simple, but it has bin,oct,hex and decimal and the answer 
  288.   can be transferred into your editor or another program as if you had typed 
  289.   it in yourself. You could use the key pad for entering numbers and F1-F3
  290.   for selecting bin-decimal. CRSR RIGHT is transfer and [ is CLEAR ALL.
  291.   ESC for quit. 
  292.  
  293.  
  294.  
  295.  
  296.  
  297. POINTER BLANKER OFF          ALT/CTRL F6
  298. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  299.   This will disable the pointer blanking and restore the pointer.  
  300.  
  301.   The pointer blanker will remove the pointer from the screen when a key is
  302.   pressed and display it again when the mouse is moved.
  303.  
  304.  
  305.  
  306.  
  307.  
  308. POINTER BLANKER ON           ALT/CTRL F7
  309. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  310.   This will enable the pointer blanking.
  311.  
  312.  
  313.  
  314.  
  315.  
  316. SCREEN DUMP                  ALT/CTRL F8
  317. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  318.   This will dump the current screen to the printer. It uses the preferences,
  319.   so the density and color/gray scale will depend on the selections made in
  320.   the preferences.
  321.  
  322.   The screen dump may take some time to perform, so be patient.
  323.  
  324.  
  325.  
  326.  
  327.  
  328. ALARM                    ALT/CTRL and F9
  329. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  330.   This will prompt for a time (Minutes) and a message that shall be
  331.   displayed when the time has passed.
  332.   The message can be up to 80 characters long.
  333.   The message can be displayed as many lines, by using CTRL + J as
  334.   linefeed in the string.
  335.   The alarm can be switched OFF by entering 0 as the time.
  336.  
  337.  
  338.  
  339.  
  340.  
  341. IFF-PICTURE SAVER       ALT/CTRL and F10
  342. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  343.   This will save the first screen as an IFF-picture.
  344.   It will first prompt you for a filename and than save it.
  345.   The picture will not be crunched, so if you want to crunch it you
  346.   must load it in to Deluxe Paint or another paint program and save it
  347.   from there. 
  348.  
  349.  
  350.  
  351.  
  352.  
  353. AUDIO FILTER ON/OFF        ALT/CTRL and * (keypad)
  354. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  355.   This will toggle the amiga's audio filter on and off. The power led
  356.   will indicate the the state of the filter. Bright light for ON and
  357.   dimmed light for OFF.
  358.  
  359.  
  360.  
  361.  
  362.  
  363. 50/60Hz  ON/OFF            ALT/CTRL and / (keypad)
  364. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  365.   This will toggle the screen from 50 to 60Hz. This only works
  366.   on Amigas with the 'Super Fat Agnus' installed. 
  367.  
  368.  
  369.  
  370.  
  371.  
  372. SCREEN SHUFFLER               ALT/CTRL and CRSR UP
  373. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  374.   <WITH ACTIVATE>
  375.   This will send the first screen to the back, and activate the
  376.   first window on the screen that will become the first.
  377.  
  378.  
  379.  
  380.  
  381.  
  382. SCREEN SHUFFLER             ALT/CTRL and CRSR DOWN
  383. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  384.   <WITHOUT  ACTIVATE>
  385.   This will send the first screen to the back.
  386.   No activating will be done, so you will have to activate a window
  387.   yourself by clicking in the window to activate with the mouse.
  388.  
  389.  
  390.  
  391.  
  392.  
  393. WINDOW SHUFFLER            ALT/CTRL and CRSR RIGHT
  394. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  395.   If you have more than one window on a screen, you can move
  396.   the one at the back into the front and the other back to the back.
  397.   Back to front. This will work from with in other Space II utilities,
  398.   so you can get back windows that have come behind other windows (maybe
  399.   windows without depth-gadgets)
  400.  
  401.  
  402.  
  403.  
  404.  
  405. WINDOW SHUFFLER             ALT/CTRL and CRSR LEFT
  406. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  407.   If you have more than one window on a screen, you can move
  408.   the one at the back into the front and the other back to the back.
  409.   Front to back. This will work from with in other Space II utilities,
  410.   so you can get back windows that have come behind other windows (maybe
  411.   windows without depth-gadgets)
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418. TEXT RESCUER           ALT/CTRL and ENTER (keypad)
  419. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  420.   If you have had a crash when you have been working with a text editor,
  421.   program editor, Seka xxx, AsmOne or something that uses ascii text,
  422.   you can use this utility to scan the memory and save the text.
  423.   The only thing you must do is to include the following text in your
  424.   texts.
  425.  
  426.  
  427.   In the start of every sources,docs or texts you add the following:
  428.  
  429.   #RESCUE#
  430.  
  431.   This can be commented away like this:
  432.  
  433.   ;#RESCUE#                   Assembler
  434.  
  435.   (*#RESCUE#*)  or
  436.   {#RESCUE#}                            Pascal
  437.  
  438.   /*#RESCUE#*/                          C
  439.  
  440.   If you include this in your sources, there is a chance that it can
  441.   survive a GURU or some other kind of crashes.
  442.  
  443.   If you know what the first and last chars in your text are, you can
  444.   also search after those.
  445.  
  446.   Example:
  447.          *MyStart*
  448.         .
  449.         .
  450.         .
  451.         .
  452.         .
  453.         .
  454.         *MyEnd*
  455.  
  456.  
  457.   (If some texteditors don't use ASCII 10 (Linefeed) as line separators,
  458.   (AsmOne) you can find the start and the end of the text, and than
  459.   convert ASCII 0 to ASCII 10.)
  460.  
  461.   When you activate the rescue option, the screen will flash to show you
  462.   that something is going on, and when the text is found a requester
  463.   will be displayed. You can no select a end-of-text marker and see if
  464.   the size of the text found is the right size. If the size is right, you
  465.   can now save the text found and than continue, or you can break
  466.   the search.
  467.  
  468.   You can also interrupt the search by pressing the left mousebutton.
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475. SWITCH BLANKER MODE        ALT/CTRL and . (Keypad)
  476. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  477.   This will toggle the blanking mode. The screen will flash to indicate
  478.   the switch.
  479.   The colour dimmer is a more prossesor time friendly, it will use allmost
  480.   no prossesor time. This mode can be used when other task requier as much
  481.   of the 68000 as possible (Raytracers...)
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488. DISPLAY EXEC VECTORS        ALT/CTRL and BACKSPACE
  489. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  490.   This will display six of the vectors in the ExecBase. The six vectors
  491.   are used by some viruses to link them self into memory and survive a
  492.   varm reset. You can reset the vectors if you want to.
  493.  
  494.  
  495.   The Vectors will also be checked each minute, and if they are non-zero
  496.   the requester will be displayed. This can discover viruses that has been
  497.   started from a program and linked it self into the vectors.
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504. DISPLAY BOOT-BLOCK         ALT/CTRL and 4 (Keypad)
  505. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  506.   This will display the boot-block on the disk in DF0 as a ASCII-dump.
  507.   You could use this to check disks for bootblock viruses and to view
  508.   the boot-block.
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515. INSTALL BOOT-BLOCK         ALT/CTRL and 5 (Keypad)
  516. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  517.   This will install a standard bootable boot-block on the disk in
  518.   DF0. This is the same boot-block as the one you get by using
  519.   the DOS command Install.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526. UNINSTALL BOOT-BLOCK       ALT/CTRL and 6 (Keypad)
  527. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  528.   This will make the disk in DF0: unable to boot.
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536. --------------------------------------------------------------------------------
  537.   All of the functions should work one any legally opened intuition screen.
  538.   Not on custom screens made by hacking with copperlists. All functions will
  539.   make popup windows on the window you are currently working on. You need the
  540.   'req.library' in the Libs: directory on your startup-disk for using 
  541.   this program.
  542.  
  543.  
  544.  
  545.   The 'req.library' was written by Colin Fox (of Pyramyd Designs)
  546.   and Bruce Dawson (of CygnusSoft Software). Req.library is a freely
  547.   distributable library that may be used in commercial products
  548.   without paying any royalties.
  549.  
  550.   The requester library must be distributed with the documentation
  551.   file (req.doc), and the three include files req.h, reqbase.h and reqbase.i.
  552.  
  553.   (** BUG REPORT
  554.    I have discovered a small bug in the filerequester. If you set the
  555.    numbers of lines in the requester to more than ca. 26, some memory
  556.    will not be freed up after exiting the requester, a PurgeFiles call
  557.    will not help either.)
  558.  
  559.  
  560.  
  561.   The 'powerpacker.library' was written by Nico François (PowerPeak).
  562.  
  563.   (** BUG REPORT
  564.    I believe I have found a bug in the load routine of the PP.lib. If
  565.    you have mounted the VDK: device two times, it sometimes refuse to
  566.    load data from the VDK: into memory.)
  567.  
  568.  
  569.  
  570.   I will send my greetings to these great amiga programmers !!!.
  571.   Keep up the exellent work.
  572. --------------------------------------------------------------------------------
  573.